home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / cnet / cnettoolkit2a.lha / CNet_ToolKit.INTRO < prev    next >
Text File  |  1994-12-16  |  8KB  |  154 lines
  1. ****************************************************************************
  2.       CNet Tool Kit, v2.0 by PMK & DOTORAN - For CNet v3.05c & Beyond!
  3.  
  4.         A Collection of Useful ARexx & MCI SubRoutines & Procedures!
  5.  
  6.          Please use ANY of these in your OWN ARexx/Text Creations!
  7.  
  8.           $VER: CNet Tool Kit, v2.0 (16-Dec-94) by Dotoran & PMK!
  9. ****************************************************************************
  10.  
  11. GENERAL INTRODUCTION
  12. ~~~~~~~~~~~~~~~~~~~~
  13.     These routines have all been tested thoroughly under CNet Amiga, v3.05c!
  14. As the majority of the user's should already be using a version of CNet in
  15. the v3.x series, we will no longer be supporting v2.63. UPGRADE or REGISTER!
  16.  
  17.     Full descriptions of the Usage and Returned Values are given for each
  18. routine, which will hopefully make you 100% aware as to EXACTLY how to use
  19. each routine.
  20.  
  21.     Some of the routines state they need to use the "rexxsupport.library"
  22. for their operations. I've found that all you really need to do to insure
  23. that this library is in place is to include this line somewhere near the
  24. beginning of your program:
  25.  
  26. a="rexxsupport.library";if ~show("l",a) then if ~addlib(a,0,-30) then exit
  27.  
  28.     The above command line will check to make sure the needed library EXISTS,
  29. and will add it to the list of available libraries. If the library does NOT
  30. exist in your LIBS: directory(or within your valid PATH assignment), then
  31. your program will terminate.
  32.  
  33.     I have found it especially useful to create an "Empty" ARexx file, which
  34. is similar to the "empty.c" framework file that the C programmers can use.
  35. It simply includes some of the things you'll find yourself typing over and
  36. over again every time you start a new ARexx project. Below is a copy of the
  37. "NewPFile" file that I use. (I have it assigned to a dock button, so a NEW
  38. pfile is only a click away at any given time!):
  39.  
  40. --- Program Starts Here ---
  41.  
  42. /**************************************************************************\
  43.         $VER:
  44. \**************************************************************************/
  45. options results ; signal on SYNTAX ; signal on ERROR ; signal on IOERR
  46. tr=transmit ; se=sendstring ; gc=getchar ; gu=getuser ; gs=getscratch
  47. a="rexxsupport.library";if ~show("l",a) then if ~addlib(a,0,-30) then exit
  48.  
  49. /* Insert Your ARexx Code Here! */
  50.  
  51. exit
  52. SYNTAX:;ERROR:;IOERR:
  53.  e1=' Error: 'rc' ('errortext(rc)')';e2='  Line: 'left(sigl,4)'File:'
  54.  gu 1311992;a=result;gu 1311960;b=result;c='"'a||b'"';e2=e2' 'c;tr e1
  55.  tr e2;logentry e1;logentry e2;e=sourceline(sigl);do while e~=''
  56.  e3='Source: 'left(e,37);tr e3;logentry e3;e=substr(e,38);end;bufferflush
  57. /** Last Edited: DD-MMM-YY ************************************************\
  58. \****************************************** BBS NAME (AAA)/PPP-SSSS *******/
  59.  
  60. --- Program Ends Here ---
  61.  
  62.     All the routines included in this file were written so that they could
  63. simply be copied(or pasted) into the above "empty" ARexx program. They will
  64. then work exactly as stated in the documentation.
  65.  
  66.     I'd like to point out the fifth line in the above program:
  67.  
  68. tr=transmit ; se=sendstring ; gc=getchar ; gu=getuser ; gs=getscratch
  69.  
  70.     This has been a HUGE time saver for some of the larger programs I've
  71. written. By assigning some of the more commonly used ARexx commands to short
  72. variables, I can then USE that variable as the actual command. See how I'm
  73. using "gu" on the second line, and "tr" on the 2nd & 3rd lines of the SYNTAX:
  74. routine in the Empty file above? These are the shortcut commands I came up
  75. with for the GETUSER and TRANSMIT commands. When a project is finished,
  76. you should delete any of the abbreviations you may NOT have used in THAT
  77. program to save a couple more bytes! (Use the FIND function of your text
  78. editor to see which commands WEREN'T used in your programs!)
  79.  
  80.     It should be noted, however, that none of the actual routines included
  81. in the ToolKit use these "abbreviations", just in case YOUR program uses
  82. some different abbreviations or none at all.
  83.  
  84.     You'll also find the file "NewPFile" within this archive as well. This
  85. is the empty starter file shown above, but within a file of it's own to save
  86. you that much more time! I've also included an ARexx version of the RUN
  87. command, which you can use to test out your ARexx creations, without having
  88. to manually add(or adopt) them into the system.
  89.  
  90. THANK YOUS & OTHER ACKNOWLEDGEMENTS
  91. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  92.     I'd like to take this space to thank a few people for their efforts on
  93. making the newest version of the ToolKit possible:
  94.  
  95. PMK, alias Peter M. Klein. Once again, it would have been near impossible
  96.     for me to complete this project if it weren't for the help of Pete. In
  97.     fact, most of the routines in BOTH ToolKits are written by Peter himself.
  98.     He has truly been a helpful guide and an inspiration to me in the 2 years
  99.     that I've known him. I wish the span of space between us(me in New York,
  100.     USA and he in Copenhagen, Denmark) was not so great, as I would sure like
  101.     to shake this man's hand!
  102.  
  103. ALL CONTRIBUTORS to the ToolKits: Aunt Bea, Thomas, Bill Beogelein, Lord of
  104.     Flies, and mUB. Some of the BEST new additions to the ToolKits were made
  105.     by these individuals! Thanks for sharing guys!
  106.  
  107. BILL BEOGELEIN, alias Bill Allen. Although I came no where NEAR tapping the
  108.     reserves this man had concerning CNet, I did use some of his routines I
  109.     thought REALLY made a difference. I'd like to plug one of his packages
  110.     in this file. If you can, please try and get ahold of a file titled
  111.     "CNet_Mods". You can find this on Frontiers, Future World, or FREQ it
  112.     from Bill's BBS using the magic name CNET_MODS. Included are MANY, MANY
  113.     examples of how you can modify your BBSTEXT and BBSMENU files. He even
  114.     includes a few ARexx Scripts you might find useful as additions to YOUR
  115.     bbs. Call Bill's place: Amiga SWHQ at 1/(810)/473-2020.
  116.  
  117. AUNT BEA, alias Henry "Hank" Priebe. Here's another guy I was able to tap
  118.     into for some great ideas. I wish we could pull him back to Earth long
  119.     enough for him to release some of his larger works, as he really DOES
  120.     have some good stuff out there that's WORTH sharing! HINT! HINT!
  121.  
  122. mUB & THOMAS, two of PMK's connections. Each of these contributers wrote mods
  123.     that I use constantly(The Mail Header and the Joystick Routine). I'm sure
  124.     PMK would also like to Thank these two guys as well! Keep up the good
  125.     work guys!
  126.  
  127. LORD OF FLIES, who was the original author of the 2-column layout for use in
  128.     the G/P/News areas. I believe it was this routine we were asked about the
  129.     MOST! Either by people asking me out of the blue if it were possible(if
  130.     they happened to see me on Future World) or if they saw the mod in use
  131.     on MY board, then it was more like, "Hey Dotoran! Way Cool! How'd you
  132.     get the 2 columns in your PFILES?!?" Again, thanks LF for a GREAT mod!
  133.  
  134. ANYONE ELSE I MAY HAVE FORGOTTEN. I'm sure there may have been one or two
  135.     people I may have forgotten, or a few that Peter might have wanted to
  136.     Thank, but was unable to as this portion was written right before the
  137.     release date, so let me take this last second to thank ANYONE ELSE that
  138.     may have had an impact on the completion of this project. PLEASE LET ME
  139.     KNOW I FORGOT YOU, so you can be OFFICIALLY ACKNOWLEDGED in the next
  140.     version we release!
  141.  
  142. WHAT ELSE DO WE NEED? / WHAT CAN YOU DO?
  143. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  144.     If you have a routine that you have found to be quite useful in many of
  145. the files that you've written, then please send us a copy. We'll look at it,
  146. optimize it(if possible), and include it in the next version of the ToolKit!
  147. Of course, we'll give YOU credit for coming up with the idea too!
  148.  
  149.     Alright, enough talk!  It's the ROUTINES you're interested in if you're
  150. reading this file right now, so I won't hold you up any longer! Hehe
  151.  
  152.                                               - Dotoran (Dave) & PMK (Pete)
  153. ****************************************************************************
  154.